NBPConfirm

Check that a specified entity still exists

#include <AppleTalk.h> AppleTalk Manager

OSErr NBPConfirm( abRecord, async);

ATNBPRecHandle abRecord; handle to an ATNBPRec

Boolean async; 0=await completion; 1=immediate return

returns Error Code; 0=no error

NBPConfirm is part of the AppleTalk alternate interface. It is recommended

that you use the preferred call, PConfirmName instead.

NBPConfirm confirms that an entity known by name and address still exists

in the names directory.

abRecord is a handle to an ATNBPRec structure. The relevant fields are as

follows:

Out-InName Type Size Offset Description

¨ abOpcode ABCallType 1 0 Always tNBPConfirm

¨ abResult short 2 2 Result code

Æ abUserReference long 4 4 For your use

Æ nbpEntityPtr Ptr 4 0 Pointer to entity name

¨ nbpDataField short 2 10 Number of addresses received

ÆnbpAddress.aSocket AddrBlock 4 14 Socket address

ÆnbpRetransmitInfo RetransType 2 16 Retransmission information

async is a Boolean value. Use FALSE for normal ( synchronous) operation

or TRUE to enqueue the request and resume control immediately. See

Async I/O.

Returns: an operating system Error Code. It will be one of:

noErr (0) No error

nbpNoConfirm (-1025) Name not confirmed

nbpConfDiff (-1026) Name confirmed at different socket

Notes: nbpEntityPtr points to a variable of type EntityName containing the

name to confirm. (No meta- characters are allowed in the entity name.) The

socket number of the entity is returned in NBPDataField.

NBPRetransmitInfo contains the retry interval and the retry count.

NBPConfirm is more efficient than NBPLookup in terms of network

traffic.

Referenced by (5):